home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Programming / EasyTools / full packs / RandomX11 / RandomX.doc < prev    next >
Text File  |  1992-09-02  |  3KB  |  111 lines
  1. RandomX V1.1 on 24/08/94
  2. ========================
  3.  
  4. WHAT DOES IT DO?
  5. ----------------
  6.  
  7. This programme creates random numbers. Wow.. NOT!. Maybe it seems pretty
  8. useless to you at the moment but I'll give some examples where it could be
  9. usefull.
  10.  
  11. AND HOW IS THIS USEFUL TO ME?
  12. -----------------------------
  13.  
  14. Random backdrop patterns - have you got several screens you like using as
  15. backdrops? Then this programme can be used in CLI from your startup-
  16. sequence to display different patterns every time you boot up. Unlike other
  17. Random number generator programmes, this programme doesn't just use the
  18. date and time to generate a random number. This means that if you have
  19. an Amiga without a clock (e.g a standard A1200) everytime you perform
  20. a boot up a new backdrop will still appear. Even if the clock still says its
  21. January 91 or whatever.
  22.  
  23. I can't actually think of other CLI examples at the moment :-( but I'm sure
  24. they're out there. 
  25.  
  26. Your own (assembly language) programmes - you can either call this programme
  27. using _LVOExecute or using the assembly source I have included. You can
  28. use this source in any programme commercial or not. All I ask is a mention
  29. in the credits or a note :-)
  30.  
  31. Also AREXX scripts can call this programme to generate a truly random
  32. number. 
  33.  
  34. HOW DO I USE IT?
  35. ----------------
  36.  
  37. If you type 'randomx ?' from CLI you will get this message:
  38.  
  39. RandomX V1.1, by A.Leppard 24/08/94. Creates a random number.
  40. To use: type Randomx [minnumber] [maxnumber]
  41.  
  42. Where minnumber and maxnumber have a maximum range of 65,535 (I cant see
  43. anyone having that many backdrops!). Examples of use:
  44.  
  45. randomx 1 218          <- random number between 1 and 218 inclusive
  46. randomx -10 10         <- random number between -10 and 10 ''
  47. randomx -1 -1000       <- random number between -1 and -1000
  48. randomx -10.009 -1.000 <- random number between -10.009 -1.000
  49.  
  50. randomx 0.000009 0.000001
  51.  
  52. etc...
  53.  
  54. Basically minnumber does not have to be less than maxnumber and that
  55. they can be positive or negative and have decimal points.
  56.  
  57. using for random backdrops
  58. --------------------------
  59.  
  60. First of all put randomx in your C: directory.
  61.  
  62. WB2,3+
  63. ------
  64.  
  65. Say you had 18 different backdrop pictures and you wanted them to be
  66. used on workbench randomly. Name the pictures 1,2,3,4,5,6,7 etc up to 18.
  67. Have them in the same drawer, for example say you had a drawer in prefs
  68. called patterns (sys:prefs/patterns) with the pictures. Add thse commands
  69. before the 'loadwb' command in your startup sequence:
  70.  
  71. randomx 1 18 >env:pattern                                  
  72. copy sys:prefs/patterns/$pattern sys:prefs/patterns/backdrop
  73.  
  74. Then set the WBPattern programme to display the picture:
  75.  
  76. 'sys:prefs/patterns/backdrop'
  77.  
  78. as your backdrop. 
  79.  
  80. WB1.3 or lower
  81. --------------
  82.  
  83. Using the same commands as above you can then use your own custom 
  84. workbench pattern programme to display them. There are workbench backdrop/
  85. pattern programmes available in the P.D.
  86.  
  87. HISTORY
  88. -------
  89.  
  90. V1.0 - Initial release. 
  91.  
  92. V1.1 - No bug fixes as such, fixed the output a bit so it didnt print
  93.        null characters so doing a copy `randomx 12` ram: 
  94.        should copy a file between 1 and 12 to the ram drawer. Also made
  95.        the output even more random.
  96.  
  97.  
  98. END BIT
  99. -------
  100.  
  101. Hope someone out there finds this programme useful. Thanks go to 
  102. Daniel O'Connor and Adrian Jenkin for the idea. The dos commands above
  103. come from Daniel.
  104.  
  105. cul8r all!
  106.  
  107. Internet: 9405571x@lux.levels.unisa.edu.au
  108. or on Fred's BBS: +618-341-5944
  109.  
  110. cu,
  111. Andrew Leppard